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INTRODUCTION 


The  success  of  any  software  development  project  depends  in 
part  on  the  quality  of  the  communication  among  the  individuals 
involved:  users,  designers,  coders  and  managers.  This  is  a 

particularly  critical  factor  in  the  development  of  a  large 
system  since  a  variety  of  individuals  perform  various  tasks  at 
different  points  in  time.  The  efficiency  with  which  later 
tasks  are  performed  depends  critically  on  the  documentation 
supplied  during  previous  phases  of  the  development  cycle. 

Thus,  both  managers  and  programmers  alike  are  interested  in  the 
relative  merits  of  the  many  types  of  documentation  currently  in 
use.  Included  among  these  are  English  descriptions,  flowcharts 
and  program  design  languages  {POLs) . 

There  have  been  several  empirical  investigations  of  the 
relative  value  of  these  different  types  of  documentation.  For 
example,  in  a  study  comparing  flowcharts  and  PDL,  Ramsey, 
Atwood,  and  Van  Doren  (1978)  found  no  difference  in  the  ease 
with  which  these  two  types  of  documentation  could  be  compre¬ 
hended;  they  did,  however,  find  an  advantage  for  PDL  as  a 
design  tool.  (For  a  summary  of  relevant  studies,  see  Sheppard, 
Bailey,  and  Kruesi,  1981.) 


In  general,  there  are  two  primary  dimensions  for  categori¬ 
zing  how  available  documentation  aids  configure  the  information 
they  present  to  programmers  (Jones,  1979) .  The  first  dimension 
is  the  type  of  symbology  in  which  information  is  presented. 

The  second  dimension  is  the  spatial  arrangement  of  this  infor¬ 
mation.  PDL,  for  example,  uses  constrained  language  or 
pseudo-code  as  the  symbology  presented  in  a  sequential  spatial 
arrangement.  Flowcharts  use  ideogram  symbols  presented  in  a 
branching  spatial  arrangement.  As  a  consequence  of  the  fact 
that  documentation  formats  vary  along  more  than  one  dimension, 
there  is  a  limit  to  the  conclusions  that  can  be  drawn  from  a 
comparison  between  two  formats  since  such  a  comparison  may  not 
allow  us  to  determine  the  source  of  any  observed  difference. 

For  example,  in  the  Ramsey  et  al.  study  cited  above,  the 
difference  between  PDL  and  flowcharts  may  be  due  to  the 
differences  in  the  symbols,  in  the  spatial  arrangement  or  to  an 
interaction  of  these  two  dimensions. 

Our  approach  to  evaluating  various  forms  of  documentation 
is  to  investigate  the  separate  and  combined  effects  of  the  type 
of  symbology  and  the  spatial  arrangement.  By  expanding  our 
realm  of  study  beyond  a  comparison  of  only  two  formats,  we  hope 
to  discover  more  general  principles  which  will  aid  software 
developers  in  selecting  from  the  many  available  documentation 
aids  as  well  as  guide  in  the  development  of  new  aids. 
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The  current  experiment  is  the  fourth  in  a  series.  In  each 
experiment,  three  types  of  symbols  were  factorially  combined 
with  three  spatial  arrangements  to  produce  nine  different 
formats. 

Type  of  Symbology 

In  Experiments  1,  2  and  3,  the  three  types  of  symbology 
consisted  of  normal  English,  PDL  and  ideograms.  Normal  English 
is  frequently  used  as  a  documentation  tool.  PDL,  which  is  less 
verbose  than  normal  English,  uses  strictly  defined  keywords  to 
describe  arguments  or  predicates.  Ideograms  are  frequently 
found  in  flowcharts  and  HIPO  charts;  a  standard  set  of  ideo¬ 
grams  has  come  to  represent  processes  or  entities  within  a 
program.  In  Experiment  4,  the  ideogram  symbols  were  replaced 
by  an  abbreviated  natural  language.  The  reason  for  this 
substitution  is  explained  below. 

Spatial  Arrangement 

In  all  four  experiments,  the  spatial  arrangements  were 
sequential,  branching,  and  hierarchical.  A  sequential  arrange¬ 
ment  is  typical  of  narrative  descriptions,  program  listings  and 
PDL,  while  a  branching  arrangement  is  typical  of  flowcharts.  A 
hierarchical  arrangement  is  not  generally  used  for  individual 
module  specifications  but  is  used  at  the  system  level  to 
present  a  visual  display  of  the  relationship  among  modules. 
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The  results  of  the  first  three  experiments  are  described 
briefly  in  the  following  sections.  The  first  experiment,  which 
is  described  in  Sheppard,  Kruesi,  and  Curtis  (1981),  investi¬ 
gated  the  influence  of  these  dimensions  on  comprehension 
performance.  The  second  experiment  examined  the  performance  of 
programmers  as  they  translated  the  various  documentation 
formats  into  code  (Sheppard  and  Kruesi,  1981)  while  the  third 
experiment  examined  performance  on  a  debugging  task. 

Effects  of  Symbology  and  Spatial  Arrangement 
on  Comprehension 

In  the  first  experiment  (Sheppard,  Kruesi  &  Curtis,  1981) , 
seventy-two  professional  programmers  were  presented  with  docu¬ 
mentation  for  each  of  three  modular-sized  computer  programs. 

The  participants  answered  a  series  of  comprehension  questions 
for  each  program  using  only  the  documentation  (i.e.,  they  were 
not  given  the  actual  program  listing) .  The  questions  were 
presented  interactively  on  a  CRT  and  consisted  of  three 
different  types.  For  f orward-tracing  questions,  the  partici¬ 
pants  were  given  the  values  for  a  set  of  conditions  in  the 
program.  Their  task  was  to  trace  through  the  documentation  and 
find  the  first  statement  executed  under  those  conditions.  For 
backwa rd- tracing  questions,  they  were  reqired  to  locate  a  given 
statement  within  the  documentation  and  then  determine  the  set 
of  conditions  which  led  to  that  point.  For  the  input-output 
questions,  they  were  given  input  data  and  were  asked  to  deter¬ 
mine  the  value  of  particular  variables  at  a  later  point  in  the 


program. 


Both  forward  and  backward- tracing  questions  were  answered 
more  quickly  from  documentation  presented  in  PDL  or  ideograms 


than  in  normal  English.  On  the  average,  forward-tracing 
questions  were  answered  most  quickly  from  a  branching  arrange¬ 
ment  and  backward- tracing  questions  were  answered  more  quickly 
from  the  branching  and  hierarchical  arrangements.  An  examina¬ 
tion  of  the  individual  formats  revealed  that  the  sequential 
PDL,  the  branching  PDL  and  the  branching  ideogram  versions  were 
associated  with  very  quick  responses  for  both  types  of  ques¬ 
tions.  For  the  input-output  questions,  no  significant  differ¬ 
ences  were  found  as  a  function  of  the  type  of  symbology  or  the 
spatial  arrangement.  At  the  conclusion  of  the  experimental 
session,  participants  were  asked  to  list  the  type  of  symbology 
and  the  spatial  arrangement  they  most  preferred.  PDL  was  the 
most  preferred  symbology  and  the  branching  spatial  arrangement 
was  the  most  preferred  arrangement. 

Effects  of  Symbology  and  Spatial  Arrangement 
in  a  Coding  Task 

In  the  second  experiment  (Sheppard  &  Kruesi,  1981), 
thirty-six  professional  programmers  were  presented  with 
documentation  and  partially  completed  code  for  the  same  three 
programs.  The  participants  constructed  a  major  section  of  code 
at  the  middle  of  each  program.  About  fifteen  lines  were 
missing  from  the  code.  This  section  included  the  most  complex 
decision  structures  present  in  the  program. 


Substantial  differences  in  performance  were  associated  with 
the  type  of  symbology.  Coding  from  the  normal  English  formats 
took  considerably  longer  (29.7  minutes)  than  coding  from  the 
PDL  (20.5  minutes)  or  ideogram  (23.9  minutes)  versions.  An 
examination  of  the  error  data  showed  a  similar  pattern:  the 
normal  English  formats  resulted  in  a  mean  of  2.4  errors,  the 
PDL  resulted  in  0.8  error  and  the  ideograms  resulted  in  1.4 
errors . 

The  effect  of  spatial  arrangement  was  not  as  great  as  the 
effect  of  symbology.  Although  not  statistically  significant, 
the  branching  arrangement  appeared  to  be  superior  to  the 
sequential  and  hierarchical  arrangements,  particularly  in 
minimizing  errors  related  to  the  control  flow.  A  comparison  of 
the  individual  formats  revealed  that  the  sequential  PDL  and  the 
branching  PDL  resulted  in  the  highest  level  of  performance. 

The  branching  ideograms  and  the  hierarchical  ideograms  were 
also  associated  with  good  performance.  Of  the  nine  formats, 
the  sequential  normal  English  version  resulted  in  the  lowest 
level  of  performance. 

The  participants'  preferences  for  symbology  and  spatial 
arrangement  were  consistent  with  the  time  and  error  data.  PDL 
was  the  symbology  preferred  most  often  and  branching  was  the 
most  preferred  spatial  arrangement. 
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Effects  of  Symbology  and  Spatial  Arrangement 
in  a  Debugging  Task 

In  Experiment  3  (Sheppard,  Bailey  &  Kruesi,  1981),  36 
professional  programmers  were  asked  to  compare  error-seeded 
program  code  to  the  same  documentation  formats  in  order  to 
detect  and  correct  the  errors.  There  were  three  errors  per 
program.  These  errors  were  selected  from  among  those  made 
during  the  coding  task  in  Experiment  2.  The  participants  were 
told  that  the  errors  were  located  in  the  center  section  of  the 
programs  but  they  were  not  told  how  many  errors  occurred  in 
each  program.  The  dependent  variable  was  time  to  debug. 

Again,  substantial  differences  in  performance  were 
associated  with  the  type  of  symbology.  Debugging  from  normal 
English  took  longer  (18.7  minutes)  than  debugging  from  either 
PDL  (14.5  minutes)  or  ideograms  (14.2  minutes).  The  overall 
effect  of  spatial  arrangement  was  not  pronounced.  A  comparison 
of  the  individual  formats  revealed  that  the  sequential  and 
branching  PDL  again  led  to  a  high  level  of  performance  as  did 
the  branching  and  hierarchical  ideograms.  The  sequential 
normal  English  again  resulted  in  very  poor  performance. 

The  participants  had  no  preferences  for  the  type  of 
symbology  but  did  prefer  the  branching  spatial  arrangement  to 
the  sequential  and  hierarchical  arrangements. 
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Experiment  4  -  Modification 


In  the  first  three  experiments,  normal  English  resulted  in 
substantially  longer  response  times  than  the  other  two 
symbologies.  It  appeared  likely  that  at  least  part  of  this 
difference  was  due  to  the  manner  in  which  variable  names  were 
expressed.  The  normal  English  contained  an  English  description 
of  each  variable  while  the  PDL  and  ideograms  contained  the 
variables  as  they  were  used  in  the  FORTRAN  code.  Thus,  the 
normal  English  required  more  translation  from  the  documentation 
to  the  code. 

In  Experiment  4,  an  abbreviated  English  was  substituted  for 
the  ideograms  in  order  to  assess  the  extent  to  which  the 
variable  names  account  for  the  symbology  effect.  The  abbrevi¬ 
ated  English  was  identical  to  the  normal  English  with  the 
exception  that  the  variable  names  were  used  rather  than  normal 
English  descriptions.  Thus,  the  abbreviated  English  was  more 
succinct  than  the  natural  language  but  less  succinct  than  the 
PDL. 


The  task  in  Experiment  4  was  to  modify  the  three  programs. 
The  modifications  required  a  minimum  of  three  to  five  lines  of 
additional  code.  Performance  was  measured  by  the  time  to  code 
and  debug  the  modifications  and  by  the  number  of  errors. 


METHOD 


Thirty-six  professional  programmers  from  three  different 
locations  participated  in  this  experiment.  All  were  General 
Electric  employees.  The  participants  averaged  8.5  years  of 
professional  programming  experience  (S.D.  =  7.1)  and  had  used 
an  average  of  5  programming  languages  (S.D.  =  2.1). 


Independent  Variables 


The  experiment  was  designed  to  study  the  effects  of  three 
independent  variables:  the  type  of  symbology,  the  spatial 
arrangement  of  the  information  and  the  type  of  program. 


Program  type.  In  our  previous  research  (Sheppard,  Curtis, 
Milliman  &  Love,  1979)  significant  differences  in  programmer 
performance  were  often  associated  with  differences  among 
programs.  Three  programs  of  varying  types  were  chosen  for  use 
in  this  experiment.  (These  three  programs  were  used  in  the 
first  three  experiments  as  well.)  A  program  which  calculated 
the  trajectory  of  a  rocket  was  chosen  as  representative  of  an 
engineering  algorithm.  An  inventory  system  for  a  grocery 
distribution  center  represented  the  class  of  programs  that 
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manipulate  data  bases.  A  third  program  combined  these  two 
types  of  applications.  This  program  interrogated  a  data  base 
for  information  concerning  the  traffic  pattern  at  an  airport 
and  simulated  future  needs  using  a  queueing  algorithm. 

These  three  programs  were  based  on  algorithms  contained  in 
Barrodale,  Roberts,  and  Ehle  (1971).  The  algorithms  were 
modified  to  incorporate  only  the  constructs  of  sequence, 
structured  iteration,  and  structured  selection.  They  were  then 
coded  in  FORTRAN  and  verified  for  correctness.  Each  of  the 
resulting  programs  contained  approximately  50  lines  of  execut¬ 
able  code.  In  addition  a  short  algorithm  (11  lines)  was  used 
as  a  practice  program. 

One  modification  was  selected  for  each  of  the  experimental 
programs.  Prototype  modifications  were  made  to  determine  the 
minimum  number  of  additional  lines  to  complete  the  selected 
modifications.  The  rocket  and  inventory  programs  each  required 
a  minimum  of  three  additional  lines  of  code;  the  airport 
program  required  a  minimum  of  five  additional  lines  of  code. 
Descriptions  of  the  modifications  and  listings  of  the  program 
code  are  presented  in  Appendix  A. 

Type  of  Symbology.  The  statements  from  each  program  were 
translated  into  three  types  of  symbology:  normal  English, 
abbreviated  English  and  a  program  design  language  (PDL) . 


-10 


Spatial  Arrangements.  Three  spatial  arrangements  were  used 
to  represent  the  program  structure:  sequential,  branching,  and 
hierarchical.  These  three  arrangements  differed  in  the  repre¬ 
sentation  of  control  flow  and  nesting  levels.  In  the  sequen¬ 
tial  arrangement,  both  the  control  flow  and  the  levels  of 
nesting  were  represented  vertically.  In  the  branching  arrange¬ 
ment,  the  flow  of  control  was  represented  vertically  while 
nesting  levels  were  represented  horizontally.  Finally,  in  the 
hierarchical  arrangement,  the  flow  of  control  was  represented 
horizontally  while  nesting  levels  were  represented  vertically. 

Each  of  the  three  types  of  symbology  was  presented  in  the 
three  spatial  arrangements,  resulting  in  nine  documentation 
formats  for  each  program.  Appendix  B  of  this  report  contains 
the  nine  formats  for  the  rocket  program. 

Procedure 


Prior  to  the  experiment,  the  participants  were  given  a 
20-minute  training  session  in  which  they  were  shown  each 
spatial  arrangement  and  each  type  of  symbology.  The  experi¬ 
menter  described  the  control  flow  for  each  arrangement  using  a 
short  program  as  an  example;  this  program  was  not  seen  in  the 
actual  experiment.  The  procedure  for  using  the  text  editor  to 
modify  the  programs  was  also  explained  in  detail  during  the 
training  session. 
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Experimental  sessions  were  conducted  at  CRT  terminals  on  a 
VAX  11/780.  All  coding  was  done  in  FORTRAN.  The  participants 
were  first  given  a  practice  program  and  a  short  description  of 
the  modification.  The  existing  code  could  be  listed  on  the  CRT 
screen  by  using  the  editor.  When  satisfied  that  the  modifica¬ 
tion  was  correct,  a  participant  exited  from  the  editor  and 
activated  a  command  file  to  compile  and  run  the  program.  If 
the  compilation  was  unsuccessful,  a  compiler  message  appeared 
on  the  screen  directly  below  the  line  or  lines  containing  the 
error.  If  the  program  compiled  without  errors,  it  was  auto¬ 
matically  executed  with  test  data,  and  the  output  from  the 
program  appeared  on  the  screen  with  one  of  the  following 
messages:  "OUTPUT  IS  CORRECT"  or  "OUTPUT  IS  INCORRECT."  In 

the  latter  case,  the  participant  was  asked  to  keep  trying  until 
the  program  had  been  modified  correctly. 

Following  the  practice  program,  the  three  experimental 
programs  were  presented.  For  each  program,  the  participants 
received  a  one-paragraph  description  of  the  modification.  They 
also  received  a  version  of  the  documentation  for  the  original 
(unmodified)  program.  The  original  code  could  be  listed  on  the 
CRT  screen.  Finally  they  received  a  data  dictionary  listing 
each  variable,  a  natural  language  description  of  it,  and  its 
data  type. 

The  participants  were  told  to  make  handwritten  modifica¬ 
tions  j on  the  documentation  sheets  before  entering  their  code  at 
the  terminal.  If  a  participant  tried  running  the  program 
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without  making  any  changes,  the  program  compiled  successfully 
but  produced  the  message  that  the  output  was  incorrect. 

An  interactive  data  collection  system  prompted  the  partici¬ 
pant  throughout  the  experimental  procedure.  The  system 
recorded  each  change  made  to  a  program.  An  interval  timer, 
accurate  to  the  nearest  second,  recorded  the  time  for  each 
action.  When  a  participant  required  more  than  one  editing 
session  to  modify  the  program  and  correct  the  errors,  the 
experimental  system  recorded  exits  from  the  editor,  any 
compilation  errors,  and  the  incorrect  outputs  generated.  From 
these  data,  the  time  to  modify  the  programs  was  calculated  by 
summing  the  times  from  the  individual  editing  sessions;  time 
for  compiling  and  running  the  programs  was  not  included. 

On  the  average,  the  participants  spent  approximately  27 
minutes  on  each  experimental  program.  They  were  required  to 
continue  working  on  a  program  until  the  modification  had  been 
completely  successful.  They  were  allowed  to  take  breaks 
between  programs. 

Following  the  experiment,  the  participants  completed  a 
questionnaire  about  their  previous  programming  experience.  The 
information  requested  included  number  of  years  of  professional 
experience,  number  of  programming  languages  known,  and  whether 
they  had  previously  worked  with  algorithms  of  the  types  used  in 
the  experiment.  The  participants  were  also  asked  about  their 
preferences  for  type  of  symbology  and  spatial  arrangement. 
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Design 

The  three  types  of  symbology  (normal  English,  abbreviated 
English,  and  PDL)  were  factorially  combined  with  the  three 
spatial  arrangements  (sequential,  branching,  and  hierarchical) 
to  produce  nine  documentation  formats.  These  nine  formats  were 
constructed  for  each  of  the  three  programs,  resulting  in  a 
total  of  27  conditions. 

Participants  received  a  documentation  format  for  each 
program.  Across  the  three  programs,  they  saw  each  type  of 
symbology  and  each  spatial  arrangement.  The  first  participant, 
for  example,  saw  the  rocket  trajectory  program  presented  in 
sequential  normal  English,  the  inventory  control  program  in 
hierarchical  PDL,  and  the  airport  traffic  program  in  branching 
abbreviated  English.  The  participants  were  assigned  to  condi¬ 
tions  according  to  the  procedures  outlined  in  Winer  (1971) . 

[See  also  Kirk  (1968)].  Each  of  the  27  conditions  was  used 
once  within  a  set  of  nine  participants.  For  this  33 
randomized  block  design,  a  minimum  of  36  participants  is 
required  to  assess  all  interactions  and  main  effects.  Across 
the  36  participants,  each  program,  symbology,  and  arrangement 
was  presented  first,  second,  and  third  an  equal  number  of  times. 
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RESULTS 


Time  to  Modify  and  Debug 

The  participants  required  an  average  of  27  minutes  to 
modify  and  debug  a  program.  This  represents  the  amount  of  time 
spent  studying  the  program,  modifying  the  documentation  format 
and  using  the  text  editor  (i.e.,  the  total  time  spent  at  the 
terminal  less  the  time  for  compiling,  linking  and  running). 

There  were  large  differences  in  the  times  required  to 
complete  the  modifications  for  the  three  programs  (Table  1) . 

The  inventory  program  required  the  least  time  to  complete  (21.2 
minutes);  the  airport  program  required  the  longest  time  (33.6 
minutes) . 


TABLE  1.  A  COMPARISON  OF  THE  DEPENDENT 
VARIABLES  FOR  THE  THREE  PROGRAMS 


PROGRAM  | 

INVENTORY 

ROCKET 

AIRPORT 

ALL 

PROGRAMS 

MEAN  TIME  TO 
COMPLETE 
MODIFICATION 
(MINUTES) 

21.2 

24.9 

33.6 

26.6 

MEAN  NUMBER  OF 
SEMANTIC  ERRORS 

0.8 

1.2 

1.2 

1 .1 
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The  differences  among  the  programs  was  verified  by  an 


analysis  of  variance  (pC001).  (See  Table  2.)  A  stepwise 
multiple  regression  equation  was  used  to  partition  the  sums  of 
squares  for  the  ANOVA.  A  logarithmic  transformation  was 
carried  out  on  the  times  to  attenuate  the  influence  of  extreme 
scores  and  to  produce  a  more  normal  distribution  (Kirk,  1968) . 


TABU  2.  SUMMARY  OF  ANOVA: 
TIME  TO  COMPLETE  MODIFICATION 


SOURCE 

!L 

11 

MS 

_F_ 

e 

TOTAL 

107 

5.68 

BETWEEN  PARTICIPANTS 

AND  REPLICATIONS 

REPLICATIONS 

3 

.03 

PARTICIPANTS  WITHIN 

REPLICATIONS 

32 

1.99 

WITHIN  PARTICIPANTS 

AND  REPLICATIONS 

PROGRAM  (P) 

2 

.75 

.38 

12.7 

.001 

SYMBOLOGY  (S| 

2 

.06 

03 

1.0 

ARRANGEMENT  (A) 

2 

.23 

.12 

4.0 

.05 

P  x  S 

4 

.34 

08 

2.7 

P  x  A 

4 

.28 

.07 

2.3 

S  x  A 

4 

.15 

.04 

1.3 

P  *  s  x  A 

8 

.54 

07 

2.3 

RESIDUAL 

46 

1.31 

03 

Table  3  presents  the  mean  time  to  complete  the  modification 
for  each  combination  of  symbology  and  spatial  arrangement. 
Differences  due  to  the  type  of  symbology  were  small.  The  PDL 
versions  were  associated  with  the  smallest  performance  times 
for  each  spatial  arrangement,  but  these  differences  were  not 
statistically  significant. 


TABLE  3.  MEAN  TIME  TO  COMPLETE 
MODIFICATION  (Minutes) 


SPATIAL 

ARRANGEMENT 

TYPE  OF  SYMBOLOGY 

NORMAL 

ENGLISH 

ABBREVIATED 

ENGLISH 

PROGRAM 

DESIGN 

LANGUAGE 

TOTAL 

SEQUENTIAL 

28.0 

28.4 

25.5 

27.3 

BRANCHING 

25.4 

22.9 

21.1 

23.1 

HIERARCHICAL 

30.9 

28.6 

28.3 

29.3 

TOTAL 

28.1 

26.6 

25.0 

26.6 

Note:  Individual  cell  means  represent  12  participants. 


A  significant  effect  for  spatial  arrangement  occurred  (p  << 
.05).  The  branching  versions  required  23.1  minutes,  while  the 
sequential  and  hierarchical  versions  required  27.3  and  29.3 
minutes  respectively.  There  were  no  signficant  two-way  or 
three-way  interactions. 
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Errors 


The  errors  made  by  the  participants  provide  insight  on  the 
difficulties  encountered  in  making  the  modifications.  Programs 
that  did  not  compile  and  run  successfully  the  first  time  were 
analyzed  to  determine  what  errors  were  present  in  the  initial 
attempt  to  make  the  modification. 

The  errors  were  assigned  to  two  general  categories: 
syntactic  and  semantic.  The  syntactic  category  included  a 
variety  of  errors  that  produced  compiler  messages.  These 
errors  were  relatively  few  in  number  and  were  easy  to  detect 
and  correct.  Unlike  the  semantic  errors,  the  syntactic  errors 
could  be  corrected  without  reference  to  the  instructions  for 
the  modification  or  to  the  documentation.  Thus,  they  are  of 
less  interest  than  the  semantic  errors. 

Table  1  shows  a  breakdown  of  the  number  of  semantic  errors 
for  each  program.  The  inventory  program  had  fewer  errors  than 
the  other  two  programs.  A  detailed  analysis  of  the  errors  for 
the  inventory  program  revealed  that  most  of  these  errors  (66%) 
resulted  from  problems  in  placing  the  statements  in  the  correct 
locations  within  the  program.  The  airport  and  rocket  programs 
were  associated  with  a  wider  variety  of  errors.  Appendix  C 
presents  a  detailed  breakdown  of  the  different  types  of  errors 
for  each  program. 
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In  teems  of  the  symbology  and  spatial  arrangement,  the 
pattern  of  errors  was  similar  to  the  pattern  for  the  modifica¬ 
tion  times.  The  effects  of  symbology  were  not  pronounced,  and 
the  branching  spatial  arrangement  was  superior  to  the  sequen¬ 
tial  and  hierarchical  arrangements  (Table  4) . 


TABLE  4.  MEAN  NUMBER  OF  SEMANTIC  ERRORS 


SPATIAL 

ARRANGEMENT 

TYPE  OF  SYMBOLOGY 

TOTAL 

NORMAL 

ENGLISH 

ABBREVIATED 

ENGLISH 

PROGRAM 

DESIGN 

LANGUAGE 

SEQUENTIAL 

1.3 

1.8 

0.8 

1.3 

BRANCHING 

0.5 

0.4 

1.1 

0.7 

HIERARCHICAL 

0.8 

1.6 

1.2 

1.2 

TOTAL 

0.9 

1.3 

1.0 

1.1 

Preferences  for  Type  of  Symbology  and  Spatial  Arrangement 

Across  the  three  programs,  each  participant  received 
documentation  in  each  type  of  symbology  and  in  each  spatial 
arrangement.  The  questionnaire  indicated  which  three  of  the 
nine  versions  they  had  experienced  during  the  experiment.  They 
were  asked  to  state  which  of  these  three  versions  they 
preferred.  Table  5  shows  these  preferences. 


TABLE  5.  PERCENT  OF  PREFERENCES  FOR 
SYMBOLOGY  AND  SPATIAL  ARRANGEMENT 


FACTOR 

% 

TYPE  OF  SYMBOLOGY: 

NORMAL  ENGLISH 

18 

ABBREVIATED  ENGLISH 

32 

PROGRAM  DESIGN  LANGUAGE 

50 

SPATIAL  ARRANGEMENT: 

SEQUENTIAL 

24 

HIERARCHICAL 

26 

BRANCHING 

50 

In  terms  of  the  type  of  symbology,  the  majority  of  partici¬ 
pants  chose  the  constrained  language,  abbreviated  English  was 
intermediate,  and  natural  English  was  the  least  preferred.  The 
branching  spatial  arrangement  was  preferred  twice  as  often  as 
the  sequential  and  hierarchical  arrangements. 

Experiential  Factors  as  Predictors  of  Performance 

Three  factors  relating  to  programming  experience  were 
compared  to  the  participants'  average  performance  on  the 
experimental  tasks.  First,  the  practice  (pretest)  program  was 
a  common  task  done  by  all  participants  and  could  therefore  be 
used  as  a  measure  of  individual  performance.  The  questionnaire 
provided  information  about  two  other  experiential  factors,  the 
number  of  years  of  programming  experience  and  the  number  of 
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programming  languages  used  by  the  participants.  Table  6  shows 
that  the  time  spent  on  the  pretest  program  was  a  predictor  of 
performance  time  on  the  experimental  programs  (r=.41).  The 
number  of  languages  used  by  the  participants  was  correlated 
with  performance  on  both  the  pretest  program  (-.39)  and  the 
experimental  programs  (-.37).  Finally,  the  number  of  years  of 
programming  experience  did  not  show  a  significant  correlation 
with  any  of  the  other  measures. 


TABLE  6.  CORRELATIONS  BETWEEN  PERFORMANCE 
MEASURES  AND  EXPERIENTIAL  FACTORS 


YEARS 

EXPERIENCE 

PROGRAMMING 

NUMBER  OF 
LANGUAGES 

PRETEST 

TIME 

MEAN  TIME  TO 
COMPLETE 
MODIFICATIONS 

—.01 

-.37* 

.41** 

PRETEST 

TIME 

-.01 

-.39** 

NUMBER  OF 
LANGUAGES 

.12 

a  =  36 

*p  <  .02 
**p  <  .01 
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DISCUSSION 


Strong  differences  were  observed  among  the  three  programs 
used  In  this  experiment.  The  inventory  control  program  was 
associated  with  the  shortest  times  and  fewest  errors,  the 
airport  scheduling  program  resulted  in  the  poorest  performance, 
and  the  rocket  trajectory  program  was  in-between.  This  result 
parallels  our  past  experiences  with  these  programs  in  the 
comprehension  and  coding  experiments.  One  explanation  for  the 
consistency  of  these  results  across  several  different  program¬ 
ming  tasks  is  that  some  types  of  algorithms  are  easier  to 
understand  and  use  than  others.  When  asked  whether  they  had 
previously  worked  with  these  types  of  algorithms,  more  partici¬ 
pants  said  they  had  worked  with  an  inventory  control  program 
(36%)  than  with  rocket  trajectory  (19%)  or  airport  scheduling 
programs  (11%) .  Thus  familiarity  may  account  in  part  for 
performance  differences  among  the  programs. 

Although  the  effect  of  type  of  symbology  is  not  pronounced 
in  this  experiment,  the  results  reflect  the  trend  that  appeared 
quite  strongly  in  the  previous  three  experiments.  The  more 
succinct  symbology,  the  PDL,  was  associated  with  better 
performance  than  the  more  verbose  symbology,  the  normal 
English.  Further,  the  novel  symbology  introduced  in  the 
present  experiment,  the  abbreviated  English,  was  less  verbose 
than  the  normal  English  but  more  verbose  than  the  PDL. 
Performance  times  for  the  abbreviated  English  fell  between  the 

times  for  the  normal  English  and  the  PDL,  thus  reinforcing  the 
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conclusion  that  the  more  succinct  the  symbology,  the  more 
quickly  the  programming  task  will  be  completed. 

The  effect  of  spatial  arrangement  was  quite  strong  in  this 
experiment.  The  branching  spatial  arrangement  was  considerably 
better  for  the  modification  task  than  the  other  two  arrange¬ 
ments.  Similar  evidence  was  obtained  in  the  coding  and  compre¬ 
hension  experiments.  In  particular  the  branching  spatial 
arrangement  seems  to  be  helpful  in  tasks  related  to  the  control 
flow  structures  of  a  program.  In  the  coding  experiment,  fewer 
logical  errors  were  associated  with  the  branching  arrangement 
than  with  the  other  two  arrangements.  In  the  comprehension 
experiment,  the  branching  arrangement  was  superior  for 
questions  that  required  hand  tracing  through  the  program  logic. 

The  participants'  preferences  for  type  of  symbology  and 
spatial  arrangement  in  this  experiment  are  consistent  with 
preferences  from  the  other  experiments.  PDL  was  the  preferred 
symbology  in  this  experiment  as  in  the  comprehension  and  coding 
experiments.  (No  preference  for  type  of  symbology  was  obtained 
in  the  debugging  experiment.)  The  branching  spatial  arrange¬ 
ment  was  preferred  in  all  four  experiments. 

As  in  our  previous  experiments,  we  compared  performance  to 
several  experiential  factors.  Performance  on  the  practice 
program  was  correlated  with  average  performance  on  the 
experimental  programs  and  was  thus  a  good  predictor  of  perfor¬ 
mance.  Number  of  years  of  programming  experience  was  not 
correlated  with  performance  but  number  of  programming  languages 
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known  was  correlated  with  performance.  Thus,  diversity  of 
experience  is  a  better  predictor  of  performance  than  length  of 
experience.  This  replicates  a  similar  result  in  our  previous 
research  (Sheppard  et  al.,  1979)  and  highlights  the  importance 
of  ensuring  that  programmers  have  an  opportunity  to  gain  broad 
applications  experience  as  part  of  their  professional 
development. 

The  four  experiments  in  this  series  each  produced  slightly 
different  results,  depending  on  the  four  types  of  experimental 
tasks:  answering  questions,  coding,  debugging  or  modifying 
programs.  No  one  particular  combination  of  symbology  and 
spatial  arrangement  proved  superior  for  all  tasks.  However, 
one  symbology,  PDL ,  was  associated  with  the  best  performance 
overall  and  was  preferred  most  often  by  the  participants. 

Choice  of  spatial  arrangement  was  not  as  clear.  The 
sequential  PDL  was  an  excellent  version.  The  hierarchical 
ideograms  were  also  suprisingly  usable  in  view  of  the  partici¬ 
pants'  previous  lack  of  experience  with  hierarchical  versions 
of  documentation.  Overall,  however,  the  branching  spatial 
arrangement  appeared  to  be  associated  with  lower  performance 
times  and  fewer  errors  than  the  other  arrangements.  Further, 
the  branching  arrangement  was  preferred  in  all  four 
experiments.  Software  managers  would  be  well  advised  to 
convert  software  specifications  to  PDL  and  should  not  feel 
constrained  to  the  standard  sequential  format. 
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APPENDIX  A 

MODIFICATION  DESCRIPTIONS  AND  PROGRAM  LISTINGS 
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EXPT4 


ROCKET  PROBLEM 


Program  ROCKET  currently  assumes  that  the  maximum  time  for  the  simulation, 
MAXT,  is  always  less  than  the  time  for  the  total  trajectory.  The  simulation 
always  ends  while  the  rocket  is  still  airborne.  More  specifically,  the 
simulation  ends  because  MAXT  has  been  exceeded  and  the  variable  FLAG  has  been 
changed.  The  flight  director  wants  program  ROCKET  modified  to  include  the 
option  to  stop  the  simulation  when  the  rocket  hits  the  ground.  He  would  also 
like  a  message  telling  him  which  situation  has  occurred.  If  the  rocket  is 
airborne  at  the  end  of  the  simulation,  the  program  should  print  the  message: 
"ROCKET  STILL  ALOFT"  and  give  the  time.  If  the  simulation  ends  because  the 
rocket  is  no  longer  airborne,  the  program  should  print  "ROCKET  HIT  GROUND"  and 
give  the  time.  (HINT:  The  rocket  has  hit  the  ground  when  the  vertical 
distance,  VDIST,  is  less  than  or  equal  to  zero.)  The  message  should  be 
printed  before  the  values  for  MASS,  VACCEL,  ...,  and  HOIST  are  printed. 

Formats  2000  and  3000  are  included  for  your  convenience. 

PLEASE  MAKE  YOUR  MODIFICATIONS  ON  THE  SPECIFICATION  SHEET  BEFORE 
PROCEEDING  TO  CHANGE  THE  CODE. 
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EXPT  4 


INVENTORY  PROBLEM 


Program  INVENTORY  prints  a  separate  invoice  for  each  grocery  store.  Along 
with  other  information,  the  invoice  lists  each  item  ordered,  the  price  per 
item  and  the  total  cost  for  that  item.  The  manager  of  the  chain  of  stores 
would  like  to  have  program  INVENTORY  modified  to  print  a  grand  total  at  the 
end  of  each  invoice.  Use  the  variable  name  GTOTAL  for  the  grand  total. 

Format  150  is  provided  for  your  convenience. 

PLEASE  MAKE  YOUR  MODIFICATIONS  ON  THE  SPECIFICATION  SHEET  BEFORE 
PROCEEDING  TO  CHANGE  THE  CODE. 
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EXPT4 


AIRPORT  PROBLEM 


Assume  that  the  FAA  has  imposed  a  new  regulation  concerning  the  amount  of 
time  an  arriving  airplane  may  remain  in  the  air  while  waiting  for  a  runway. 

If  other  runways  are  available  but  not  being  used,  the  longest  time  a  pilot 
should  wait  is  5  minutes.  Modify  program  AIRPORT  to  determine  whether  the 
maximum  waiting  time  during  simulation,  MAXWT,  has  exceeded  5  minutes.  You 
should  also  determine  the  value  of  a  new  variable,  MAXARR,  the  maximum  number 
of  planes  in  ARRQUE,  the  arrival  queue,  at  any  time  during  the  simulation.  If 
MAXWT  exceeds  5  minutes,  print  the  message:  "OPEN  ANOTHER  RUNWAY."  Otherwise 
end  the  simulation  with  the  message:  "ANOTHER  RUNWAY  NOT  NEEDED."  In  either 
case,  print  the  value  of  MAXARR  following  the  message  and  before  the  values 
for  ENDT,  ARRQUE,  ...,  NUMDEP.  Formats  110,  120  and  130  are  included  for  your 
convenience. 

PLEASE  MAKE  YOUR  MODIFICATIONS  ON  THE  SPECIFICATION  SHEET  BEFORE 
PROCEEDING  TO  CHANGE  THE  CODE. 
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ROCKET  PROGRAM 


100  c 

110 

120 

130  1 

140 

-99 

-99 

-99  3001 

-99 


PROGRAM  ROCKET 
INTEGER  MAXT,  TIME*  FLAG 

REAL  VACCEL,  WEI-OC ,  VDIST,  HACCEL,  HVELOC,  HOIST, 

ANGLE,  TILT,  GRAV.  MASS, FUEL, FORCE 

OPEN  (UNIT-1,  NAME*  "MAX.  DAT',  TYPE* 'OLD  '  ) 

OPEN  (UNIT-3,  NAME* 'RUN.  DAT  ',  TYPE*  'NEW  ' ) 

OPEN (UNIT-4,  NAME* 'TERM.  DAT',  TYPE* 'NEW ' ) 
FORMAT (1H1 ) 

WRITE (6,  3001 ) 


150  C 
160  C 
170  C 
180  C 
190  C 
200 
210 
220 
230 
240 
250 
260 
270 
280 
290 
300 
310 
320 
330 
340 
350  C 
360  C 
370  C 
380  C 
390  C 
400 
410 
420 
430 
440 
450 
460 
470 
480 
490 
500 
510 
520 
530 
540 
550 
570 


INITIALIZATION 


VACCEL  *  0. 

WELOC  *  0. 

VDIST  *  0. 

HACCEL  *  0. 

HVELOC  *  0. 

HD  I  ST  *  0. 

ANGLE  *  0. 

TILT  *  0.  3491 
GRAV  *  32. 

MASS  =  10000. 

FUEL  *  50. 

FORCE  »  400000. 
READ (1,1000)  MAXT 
FLAG  -  0 
TIME  *  1 


COMPUTATION: 


10  IF  (FLAG  .  NE.  0)  GO  TO  60 

IF  (TIME  .  GT.  100)  GO  TO  20 
MASS  *  MASS  -  FUEL 
IF  (TIME  NE.  11 >  GO  TO  30 
ANGLE  -TILT 
GO  TO  30 

20  IF  (TIME  .  NE.  101)  GO  TO  30 
FORCE  »  0.  0 

30  VACCEL  *  ((FORCE  *  COS ( ANGLE >) /MASS )  -  GRAV 
WELOC  =  WELOC  +  VACCEL 
VDIST  *  VDIST  +  WELOC 
HACCEL  *  (FORCE  *  SIN( ANGLE )) /MASS 
HVELOC  *  HVELOC  +  HACCEL 
HD I ST  *  HD I ST  +  HVELOC 
TIME  *  TIME  ♦  1  . 

IF  (TIME  .  GT.  Mr?XT>  PL  AG  *1 - **  (VBIST  ,  Li .  0)  HM  :  I 

GO  TO  10 
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580  C 
590  C 

600  C  TERMINATION: 

610  C 
620  C 

630  60  TIME  =  TIME  - 

640  WRITE (4. 4000) 

650  1  HACCEL, HVELOC, HDIST 

-99  CLOSE 'UNIT=4> 

-99  CALL  CHECK4(  1.  TIME,  0,  0,  0,  0,  0,  0.  0) 


-99  WRITE (3,  4000) MASS,  VACCEL,  WELOC.  VDIST, 

-99  1  HACCEL, HVELOC, HDIST 

-99  WRITE (6,  4000) MASS,  VACCEL,  WELOC,  VDIST, 

-99  1  HACCEL, HVELOC, HDIST 

-99  CLOSE  ( UNIT®3  ) 

660  CLOSE ( UN I T- 1 ) 

670  STOP 

680  1000  FORMAT (13) 

690  2000  FORMAT (5X, 'ROCKET  STILL  ALOFT  AT  TIME  = 

700  1  15,  '  SECONDS') 

710  3000  FORMAT ( 5X, 'ROCKET  HIT  GROUND  AT  TIME*  ',15, '  SECONDS') 

720  4000  FORMAT  (5X,  'MASS  *  ',F22.  2/ 

730  1  5X,  'VERTICAL  ACCEL  *  ',F12.  2/ 

740  2  5X,  'VERTICAL  VELOC  =  ',F12.  2/ 

750  3  5X,  'VERTICAL  DIST  =  ',F13.  2/ 

760  4  5X,  'HORIZONTAL  ACCEL  =  ',F10.  2/ 

770  5  5X,  'HORIZONTAL  VELOC  *  ',F10.  2/ 

780  6  5X,  'HORIZONTAL  DIST  =  ',FU .2) 

790  END 


_ <VOX»T  'QT.  »  WftXTf  {  V,  a \M  7JMC 

(yOMT .Lt.j)  WMXTS  K%30fkrxftsl 

MASS,  VACCEL,  WELOC.  WIST?  rrn 
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INVENTORY  PROGRAM 


100 

C 

PROGRAM  INVENTORY 

110 

INTEGER  DELIV,  FLAG.  ITEM,  ONHAND,  ORDER,  RELEV, 

120 

1 

REORD,  STORE,  UNFILL 

130 

REAL  PRICE,  TOTAL 

140 

c 

-99 

GTOTAL  =  -1.0 

-99 

WRITE (6, 3001 ) 

-99 

3001 

FORMAT ( 1H1 ) 

150 

C 

160 

c 

INITIALIZATION: 

170 

c 

180 

c 

-99 

OPEN  (UNIT-4,  NAME- 'TERM.  DAT '  ,  TYPE  =  NEW'  ) 

190 

OPEN  ( UN I T—  1 ,  NAME- 'ORDERS.  DAT',  TYPE- 'OLD') 

200 

OPEN  (UNIT-2,  NAME= 'PURCHAS.  DAT',  TYPE- 'OLD', 

210 

1 

ACCESS- 'SEQUENTIAL  '  ) 

-99 

OPEN  (UNIT-3,  NAME-  'RUN.  DAT',  TYPE-  'NEW  '  ) 

220 

c 

230 

c 

240 

c 

COMPUTATION: 

250 

c 

260 

c 

-99 

CALL  SETUP 

270 

280 

10 

READ  (1,  100,  END-80)  STORE 

WRITE  (4,  110)  STORE  *  GTOTAL 

290 

20 

READ  (1,  120)  ITEM,  ORDER 

300 

IF  (ITEM  .  EQ.  0)  GO  TO  70 

310 

CALL  FETCH2( ITEM,  PRICE,  ONHAND,  RELEV,  REORD,  FLAG) 

320 

IF  (ONHAND  .  LE.  ORDER)  GO  TO  30 

330 

DELIV  =  ORDER 

340 

ONHAND  =  ONHAND  -  ORDER 

350 

UNFILL  -  0 

360 

GO  TO  40 

370 

30 

DELIV  -  ONHAND 

350 

ONHAND  =  0 

390 

UNFILL  =  ORDER  -  DELIV 

400 

40 

IF  (ONHAND  .  GT.  RELEV)  GO  TO  50 

410 

IF  (FLAG  .  EQ.  0)  FLAG  =  l 

420 

430 

50 

TOTAL  -  DELIV  *  PRICE  . 

IF  (FLAG  NE.  1)  GO  TO  60  GTOTAL*  GTOTAL  +  TOTAL 

440 

WRITE  (2,  130)  ITEM,  REORD 

450 

FLAG  =  2 

460 

60 

WRITE (4, 140)  ITEM,  PRICE,  ORDER,  DELIV,  UNFILL, TOTAL 

470 

CALL  UPDATE  (ITEM,  ONHAND,  FLAG) 

480 

GO  TO  20 

490 

500 

70 

go  to  id* - wnrre  gtotal 
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510  C 

520  C 

530  C 

540  C 

550  C 

560 

-99 

570 

-99 

-99 

-99 

-99 

-99 

580 


TERMINATION: 


80  CLOSE  <UNIT=1) 

CLOSE ( UNI T=4) 

CLOSE  <UNIT=2) 

CALL  CHECK4<2,  0,  0,  0,  0,  0,  0.  GTOTAL,  0) 

WRITE  (3,140)  ITEM,  PRICE,  ORDER-  DELIV,  UNFILL, TOTAL 
WRITE  (3,  150)  GTOTAL 

CLOSE  (UNIT=3) 

90  CONTINUE 
STOP 


590 

100 

FORMAT 

<  12) 

600 

110 

FORMAT 

(//,  5X,  'INVOICE  FOR  STORE  NUMBER 

:  ',  13) 

610 

120 

FORMAT 

(13,  15) 

620 

130 

FORMAT 

(217) 

630 

140 

FORMAT 

( 5X,  'ITEM  NUMBER: 

Ill  /  5X, 

640 

1 

'PRICE 

PER  ITEM:  *',  F5.  2 

/  5X,  'NUMBER 

ORDERED:  ', 

650 

2 

18,  /5X, 

'NUMBER  DELIVERED: ' 

,  16/  5X, 

660 

3 

'UNABLE 

TO  DELIVER.  ',  I5/5X, 

'TOTAL  PRICE 

*',  F8.  2) 

670 

150 

FORMAT 

(/,  5X,  'TOTAL  PRICE 

FOR  ALL  ITEMS: 

*  FlO.  2) 

680 

END 
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AIRPORT  PROGRAM 


100  c 
110 
120 
130 
-99 
-99 
-99 
-99 
-99 
140  C 
150  C 
160  C 
170  C 
ISO  c 
190 
200 
210 
220 
230 
240 
250 
260  C 
270  C 
280  C 
290  C 
300  C 
310 
320 
330 
340 
350 
360 
370 
380 
390 
400 
410 
420 
430 
440 
450 
460 
470 
480 
490 
500 


PROGRAM  AIRPORT 

INTEGER  ARRQUE,  EEGINT,  CLEAR,  DEPGUE.  ENDT.  MAXWT 
INTEGER  NUMARR,  NUMDEP,  TIME 
REAL  ARPROE,  DPPROB,  RAND1,  RAND2,  RSEED 
OPEN  <UNIT=3,  NAME=/RUN.  DAT',  TYPE* 'NEW  ) 

001  FORMAT ( 1H1 ) 

OPEN  (UP4IT=4,  NAME=  'TERM.  DAT  TYPE-  'NEW  '  ) 

MAXARR  ■  999 
WRITE (6, 3001 ) 


INITIALIZATION: 


- - MMARR  s  0 

CALL  FETCHi (BEGINT,  ARPROB,  DPPROE,  ARRQUE,  DEPQUE, 
1  CLEAR ) 

RSEED  =  0.  0 
NUMARR  =  0 
NUMDEP  a  0 
TIME  =  3EGINT 
ENDT  =  BEGINT  +  20 


COMPUTATION: 


10  IF  (TIME  .  GT.  ENDT)  GO  TO  60 
RAN01  =  RND( RSEED) 

IF  ( RAN01  .  GT.  ARPROB)  GO  TO  20 
ARRQUE  =  ARRQUE  +•  1 

20  RAND  2  =  RND(RSEED)’* - XF  .6T.  MAX  AM)  AMX/MR  *  AfltQue 

IF  (RAND2  .  GT.  DPPROB)  GO  TO  30 
DEPQUE  =  DEPQUE  +  1 

30  IF  (CLEAR  GT.  TIME)  GO  TO  50 
IF  (ARRQUE  .  LE.  0)  GO  TO  40 
ARRQUE  =  ARRQUE  -  1 
NUMARR  =  NUMARR  +  1 
CLEAR  =  TIME  +  3 
GO  TO  50 

40  IF  (DEPQUE  . LE.  0)  GO  TO  50 
DEPQUE  =  DEPQUE  -  1 
NUMDEP  =  NUMDEP  +  1 
CLEAR  3  TIME  +  2 

50  TIME  *  TIME  +  1 
GO  TO  10 

60  MAXWT  3  (CLEAR-ENDT)  ♦  ( ARRQUE*3 )  +  (DEPGUE*2> 
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510  C 
520  C 

530  C  TERMINATION:  XF  (#MWT  .61 .  S)  W*Z7T  (¥,/& 

540  c  xf  (mmwt  .if.  s)  w ssrr(*,j2ri 

550  c  '  - Utoxn/v,j30)  AHUM* 

560  80  WRITE  (4,  100)  ENDT ,  ARRGUE,  NUMARR,  DEPQUE, 

570  1  NUMDEP 

-99  CLOSE (UNIT=4) 

-99  CALL  CHECK4(3,  MAXARR,  0,  0,  0.  0,  0,  0-  0) 

-99  WRITE (6,  100)  ENDT,  ARRGUE, NUMARR,  DEPGUE, NUMDEP 

-99  WRITE  (3,100)  ENDT,  ARRQUE,  NUMARR , DEPGUE, NUMDEP 

-99  IF  (MAXARR  .  NE.  999)  WRITE  (6,120)  MAXARR 

-99  WRITE  (3, 130)  MAXARR 

-99  CLOSE  (UNIT=3) 

550  STOP 


590  100  FORMAT  (6X,  'ENDING  TIME  FOR  SIMULATION:  ',  15/ 

600  l  12X,  'ARRIVAL  QUEUE.  ',  I5/UX,  'NUMBER  ARRIVED  ',15/ 

610  1  10X, 'DEPARTURE  QUEUE: ',  I5/10X,  NUMBER  DEPARTED. 

620  1  15) 

630  110  FORMAT  (5X,  'OPEN  ANOTHER  RUNWAY  ') 

640  120  FORMAT  (5X,  'ANOTHER  RUNWAY  NOT  NEEDED  ') 

650  130  FORMAT  (5X,  'MAXIMUM  #  OF  ARRIVALS  IS',  15) 

660  END 
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APPENDIX  B 

DOCUMENTATION  FORMATS  FOR  ROCKET  PROGRAM 
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PROGRAM  TO  SIMULATE  THE  PATH  OF  A  ROCKET 
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If  the  simulation  time  is  less  than  or  equal  to  100,  DECREASE  the  mass  of 

THE  ROCKET  BY  THE  AMOUNT  OF  FUEL  EXPENDED  PER  SECOND  AND  CHECK  TO  SEE  IF 
THE  TIME  EQUALS  11 J  IF  SO,  SET  THE  ANGLE  OF  THE  ROCKET  TO  THE  DEGREE  OF  TILT. 

Otherwise  (if  the  simulation  time  is  greater  than  100)  check  to  see  if  it 
EQUALS  101;  IF  SO,  SET  THE  FORCE  OF  THE  ROCKET  TO  ZERO. 
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This  completes  the  process  necessary  to  simulate  the  rocket  path. 
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VELOCITY,  THE  VERTICAL  DISTANCE,  THE 
HORIZONTAL  ACCELERATION,  THE  HORIZONTAL 

velocity,  and  the  horizontal  oiitance. 
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!ic  tn|  maijnuh  n*t  foa  t*i 
SIMULATION  MO*  THE  MU  ’•JU 


MClUtl  THf  NASS  OT  Th£ 
ROCKET  RY  THt  AMOUNT  OF 
FUEL  tXHNOU  PI*  SECOND. 
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INCREASE  THt  VERTICAL  VELOCITY  IT  THE  VERTICAL 
ACCELERATION. 

Increase  m  vertical  distance  iy  the  vertical 

VELOCITY. 

Calculate  the  horizontal  acceleration  as  follows: 
ftjLTIPLY  THE  force  of  the  rocket  it  the  SINE  of 
THE  ANCLE  AT  which  the  ROCKET  IS  AIMED  AN0  DIVIDE 
THIS  QUANTITY  »t  THE  MASS  OF  THt  ROCKET. 

Increase  the  horizontal  velocity  §v  the 

HORIZONTAL  ACCELERATION. 

Increase  the  horizontal  distance  »v  the 

HORIZONTAL  VELOCITY. 
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This  completes  the  process  necessary  to  simulate  the  rocket  path, 


ABBREVIATED  ENGLISH  -  BRANCHING 


CALCULATE  VACCEL  A*  fOLLOMl 
fluLTin.,  FORCE  it  THE  count  of  mil > 

DIVIDE  TmII  QUANT  I  It  It 

PASS  AND  Thin  suitiact  GRAV. 

Increase  WELOC  »t  VACCEL. 
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wax 
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HOIST 
W6U 
Set  TILT  to  0.3491. 

Sir  GRAF  to  32. 

Set  "ASS  to  10000. 

Sit  FXl  to  50. 

Sit  FORCE  ro  *00000. 
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Sit  FLAG  to  Zero. 
Sit  TIKE  to  onc. 


If  Tift  is  uss  than 
oa  equal  to  IX 


Calculate  VACCEL  as  follows: 
f*JLTIFLT  FORCE  iv  tmi  cosine  Of  AM6LE; 


Inc* ease  Tift  it  one. 


OIVtDC  THIS  QUANTITY  it 

TASS  a*  THfpi  suitract  GRAV. 
Increase  WElX  iy  VACCa 
Increase  VDIST  it  wax. 

Calculate  HACCa  as  follows: 

.•ViLTifLT  FORCE  IT  THC  SINE  Of  ASGLE 
AND  OlVIDf  THIS  QUANTITY  IT  PASS. 

Increase*  HVEIX  it  HACCa. 

Increase  HDIST  it  HVaX. 


if  Tit 
equals  101 


StT  WOE  TO  TILT. 


SCT  FORCE  TO  ZERO. 
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IF  TIME  -  101 


SET  VACCEL  •  UFOKE  *  COS(ANGLE)  )/MASS)  -  6RAV 
SET  VVELOC  •  WLOC  ♦  VACCEL 
SET  VDIST  -  vD!ST  *  VVELOC 


END  OF  »OC*E 
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WELOC,  VDISTi  HACCEL, 
HVELOC,  HD 1ST 
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